Programming With QuickTime VR
| Previous | Chapter Contents | Chapter Top | Next |
The QuickTime VR Manager provides routines for obtaining a QTVR track and a new movie instance.
You can use the QTVRGetQTVRTrack function to get a QTVR track contained in a QuickTime movie to use in the QTVRGetQTVRInstance call.
Track QTVRGetQTVRTrack (Movie theMovie, SInt32 index);
The QTVRGetQTVRTrack function returns, as its function result, a track identifier for the QTVR track that has the index specified by the index parameter in the QuickTime movie specified by the theMovie parameter. If there is no such track, QTVRGetQTVRTrack returns the value nil .
QuickTime VR 2.1 supports files with at most one QTVR track, hence the value for the index parameter should always be one. Future versions may support multiple QTVR tracks per file.
Panorama and object movies made with QuickTime VR version 1.0 have no QTVR track. The QTVRGetQTVRTrack function returns the track ID of the panorama track for version 1.0 panorama movies and the track ID of the image video track for version 1.0 object movies. For non-QTVR movies, the QTVRGetQTVRTrack function returns nil.
You can use the QTVRGetQTVRInstance function to get an instance of a QuickTime VR movie.
OSErr QTVRGetQTVRInstance (
QTVRInstance *qtvr,
Track qtvrTrack,
MovieControllermc);
The QTVRGetQTVRInstance function returns, in the qtvr parameter, an instance of the QuickTime VR movie specified by the qtvrTrack parameter. If qtvrTrack does not specify a QTVR track, QTVRGetQTVRInstance returns nil in the qtvr parameter and an error code as its function result. You need a QuickTime VR movie instance to call most other QuickTime VR functions.
| Previous | Chapter Contents | Chapter Top | Next |